docs: remote agent control spec (Astation v1)#4
Merged
Conversation
Self-contained spec for v1 of driving a coding agent (claude/codex) running under atem from Astation macOS, over the existing relay/direct channel. Up-lane only: text / voice / keys → atem injects to the agent PTV stdin; output watched in atem's terminal (no screen mirror). Grounded in Astation's real code (AstationMessage, AstationHubManager sendHandler + routeToFocusedAtem + relay envelope, VoiceCodingManager). Defines the authoritative `agentInput` wire contract (atem_id = relay envelope; payload = agentId + input) and the concrete v1 task list so a fresh agent on the build/test Mac can start without the Atem repo. 🤖 Built with SMT <smt@agora.build>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds the Astation-side v1 spec for remote agent control — driving a coding agent (Claude Code / Codex) running under atem from Astation (macOS) via text, voice, or control keys over the existing Astation↔atem channel.
docs/specs/2026-05-28-remote-agent-control-design.md(self-contained — no Atem repo needed to start):agentInputmessage ({agentId?, kind: "text"|"key", text?, key?}) wrapped in the existing relay envelope ({atem_id, payload}—atem_idis the envelope's job, not the payload's).AstationHubManager.sendHandler/routeToFocusedAtem), voice (VoiceCodingManager+sendVoiceCommand, ConvoAI ASR), andAstationMessageplumbing.agentInputcase, asendAgentText/sendAgentKeypair mirroringsendVoiceCommand, and a minimal control UI (text field + key bar; mic reused as-is).Counterpart design lives in the Atem repo at
designs/remote-agent-control.md; this spec is the authoritative wire contract both sides match.Docs only — no code.
Generated with SMT smt@agora.build